Compile on Windows/pt-br

Licença

Compilar no linux

Index

Esta página explica passo a passo como compilar o FreeCAD 0.19 ou mais recente no Windows usando o compilador MSVC da Microsoft. Para obter informações sobre como usar MSYS2/MinGW, consulte Compilar no MinGW. Para outras plataformas, consulte Compilação.

Pré-requisitos

Compilar o FreeCAD no Windows requer várias ferramentas e bibliotecas.

Obrigatório

• Um compilador. O FreeCAD é testado com o Visual Studio (MSVC) — outros compiladores podem funcionar, mas as instruções de uso não estão incluídas aqui. Para obter mais detalhes, consulte a seção Compilador abaixo.

• Git (Há também frontends de GUI disponíveis para o Git, consulte a próxima seção.)

• CMakeversão 3.11.x ou mais recente.

Dica: Escolher a opção Adicionar CMake ao PATH do sistema para todos os usuários ao instalar o CMake tornará o CMake acessível a partir do prompt de comando do Windows, o que pode ser útil.

• O LibPack. Este é um único pacote contendo todas as bibliotecas necessárias para compilar o FreeCAD no Windows. Baixe a versão do LibPack que corresponde à versão do FreeCAD que você deseja compilar. Para compilar o FreeCAD 0.20 baixe o LibPack versão 2.6, para o FreeCAD 0.19 baixe o LibPack versão 1.0. Extraia o LibPack para um local conveniente. (Se o computador não reconhecer a extensão .7z, você deve instalar o programa 7-zip.)

Nota: É altamente recomendável compilar o FreeCAD com a versão do compilador para a qual o LibPack foi projetado. Por exemplo, você pode ter problemas ao compilar o FreeCAD 0.20 usando o MSVC 2017 porque o LibPack foi projetado para ser criado com o MSVC 2019 ou mais recente. Para atualizar seu LibPack mais tarde, consulte a seção Atualizando o LibPack.

Programas opcionais

• Um frontend GUI para Git. Existem vários frontends disponíveis, veja esta lista. O principal benefício de um frontend é que você não precisa aprender os comandos do Git para obter o código-fonte do FreeCAD ou enviar patches para o repositório GitHub do FreeCAD.

A seguir, descrevemos o tratamento do código-fonte usando o frontend TortoiseGit. Este frontend se integra diretamente ao explorador de arquivos do Windows e tem uma grande comunidade de usuários para obter ajuda caso você tenha problemas.

• O NSIS é usado para gerar o instalador do FreeCAD Windows.

Código fonte

Agora você pode obter o código fonte do FreeCAD:

Usando um frontend

Ao usar o frontend Git TortoiseGit:

1. Crie uma nova pasta onde o código-fonte será baixado.
2. Clique com o botão direito do mouse nesta pasta no explorador de arquivos do Windows e selecione Git Clone no menu de contexto.
3. Uma caixa de diálogo será exibida. Nele, insira a URL do repositório Git do FreeCAD

https://github.com/FreeCAD/FreeCAD.git

e clique em OK.

O código fonte mais recente será baixado do repositório FreeCAD Git e a pasta será rastreada pelo Git.

Usando a linha de comando

Para criar uma ramificação de rastreamento local e baixar o código-fonte, abra um terminal (prompt de comando) e alterne para o diretório desejado e digite:

git clone --recurse-submodules https://github.com/FreeCAD/FreeCAD.git

Compilador

O compilador padrão (recomendado) é o MS Visual Studio (MSVC). Embora possa ser possível usar outros compiladores, por exemplo, gcc via Cygwin ou MinGW, ele não é testado ou abordado aqui.

Você pode obter uma versão gratuita do MSVC (para uso individual) baixando a edição comunitária do MS Visual Studio.

Para aqueles que querem evitar a instalação do enorme MSVC com o mero propósito de ter um compilador, consulte CompileOnWindows - Reduzindo o espaço ocupado pelo disco.

Nota: Embora a edição comunitária do MSVC seja gratuita, para usar o IDE por mais de 30 dias de avaliação, você deve criar uma conta da Microsoft. Se você só compilar usando a linha de comando, você não precisa do IDE e, portanto, nenhuma conta da Microsoft.

Como um IDE alternativo livre e OpenSource você pode usar o KDevelop. Você pode usar o KDevelop para modificar e escrever código C++, mas deve usar a linha de comando para compilar.

Configuração opcional do caminho do sistema

Opcionalmente, você pode incluir os caminhos para algumas pastas para a variável PATH do sistema. Isso é útil se você quiser acessar programas nessas pastas a partir da linha de comando/powershell ou se quiser que programas especiais sejam encontrados pelo compilador ou CMake. Além disso, adicionar pastas ao PATH pode ser necessário se você não usou as opções correspondentes ao instalar o programa.

• Você pode incluir a pasta do seu LibPack na variável PATH do sistema. Isso é útil se você planeja criar várias configurações/versões do FreeCAD.
• Se você não usou a opção para adicionar o CMake ao PATH durante a instalação, adicione sua pasta de instalação

C:\Arquivos de Programas\CMake\bin para o PATH.

• Se você não usou a opção de adicionar TortoiseGit ao PATH durante a instalação, adicione sua pasta de instalação

C:\Arquivos de Programas\TortoiseGit\bin para o PATH.

Para adicionar caminhos de pasta à variável PATH:

1. No menu Iniciar do Windows, clique com o botão direito do mouse em Computador e escolha Propriedades.
2. Na caixa de diálogo exibida, clique em Configurações avançadas do sistema.
3. Outra caixa de diálogo será aberta. Clique lá na aba Avançado em Variáveis de Ambiente.
4. Novamente, outra caixa de diálogo será aberta. Selecione então a variável Path e clique em Edit.
5. E novamente outra caixa de diálogo será aberta. Clique lá em Novo e adicione ao caminho para a pasta do Git ou do LibPack.
6. Finalmente, pressione OK e feche todas as caixas de diálogo pressionando OK também.

Configuração

Depois de ter todas as ferramentas, bibliotecas e código-fonte do FreeCAD necessários, você está pronto para começar o processo de configuração e compilação. Este processo prosseguirá em cinco etapas:

1. Execute o CMake uma vez para examinar seu sistema e iniciar o progresso da configuração (isso informará que ele falhou).
2. Ajuste as configurações necessárias do CMake para definir os locais do LibPack e ativar o Qt5.
3. Execute novamente o CMake para finalizar a configuração (desta vez ele deve ter êxito).
4. Use o CMake para gerar o sistema de compilação do Visual Studio.
5. Use o Visual Studio para criar o FreeCAD.

CMake

Primeiro, configure o ambiente de compilação usando o CMake:

1. Abra a GUI do CMake
2. Especifique a pasta de origem do FreeCAD.
3. Especifique uma pasta de compilação. Isso pode ser compilado na pasta que você clonou o repositório porque esse caminho é ignorado pelo git. Não use a pasta de origem. O CMake criará essa pasta se ela não existir.
4. Clique em Configurar.
5. Na caixa de diálogo exibida, especifique o gerador que deseja usar: na maioria dos casos, você usará os padrões nesta caixa de diálogo. Para o MS Visual Studio padrão, use o Visual Studio xx 2yyy onde xx é a versão do compilador e 2yyy o ano de seu lançamento. É recomendável usar a opção padrão Usar compiladores nativos padrão.

Nota: É importante especificar a variante de bit correta. Se você tiver a variante de 64 bits do LibPack, você também deve usar o compilador x64.

Isso iniciará a configuração e falhará devido à falta de configurações. Isso é normal, você ainda não especificou o local do LibPack. No entanto, existem outras falhas que podem ocorrer que exigem alguma ação adicional de sua parte.

Se ele falhar com a mensagem que Visual Studio não pôde ser encontrado, o suporte CMake no MSVC ainda não está instalado. Para fazer isso:

1. Abra o IDE do MSVC
2. Use o menu Ferramentas → Obter ferramentas e recursos
3. Na guia Cargas de trabalho, habilite o desenvolvimento de área de trabalho com C++
4. No lado direito, agora você deve ver que o componente Visual C++ tools for CMake será instalado.
5. Instale-o.

Se ele falhar com uma mensagem sobre a versão errada do Python ou Python ausente, então:

1. Use a caixa "Pesquisa:" no CMake para procurar a cadeia de caracteres "Python"
2. Se você vir um caminho como C:/Program Files/Python38/python.exe, o CMake reconheceu o Python que já está instalado no seu PC, mas essa versão não é compatível com o LibPack. Como o LibPack inclui uma versão compatível do Python, modifique as seguintes configurações do Python no CMake para seus caminhos (supondo que o LibPack esteja na pasta D:/FreeCAD-build/FreeCADLibs_2_8_x64_VC2019):

Se não houver nenhum erro sobre o Visual Studio ou Python, tudo está bem, mas o CMake ainda não sabe todas as configurações necessárias. Portanto, agora:

1. Pesquise no CMake a variável FREECAD_LIBPACK_DIR e especifique o local da pasta LibPack que você baixou anteriormente.
2. (Se construir FreeCAD 0.19) Procure a variável BUILD_QT5 e habilite essa opção.
3. (Se estiver planejando executar diretamente da pasta de compilação, como para depuração) Procure e habilite as seguintes opções:
   • FREECAD_COPY_DEPEND_DIRS_TO_BUILD
   • FREECAD_COPY_LIBPACK_BIN_TO_BUILD
   • FREECAD_COPY_PLUGINS_BIN_TO_BUILD
4. Clique em Configurar novamente.

Agora não deve haver erros. Se você continuar a encontrar erros que você não pode diagnosticar, visite o fórum instalação/compilação no site do fórum FreeCAD. Se o CMake procedeu corretamente, clique em Gerar. Depois que isso for feito, você pode fechar o CMake e iniciar a compilação do FreeCAD usando o Visual Studio. No entanto, para a primeira compilação, mantenha-a aberta caso queira ou precise alterar algumas opções para o processo de compilação.

Opções para o processo de compilação

O sistema de compilação CMake oferece controle sobre alguns aspectos do processo de compilação. Em particular, você pode ativar e desativar alguns recursos ou módulos usando variáveis CMake.

Aqui está uma descrição de algumas dessas variáveis:

Construindo o FreeCAD

Dependendo do seu compilador, o processo para construir o FreeCAD será ligeiramente diferente. Nas seções a seguir, fluxos de trabalho conhecidos são descritos. Se você estiver construindo com o Qt Creator, pule para Construindo com o Qt Creator (desatualizado), caso contrário, prossiga diretamente:

Compilando a partir de cmd.exe linha de comando

Se você quiser compilar a partir da linha de comando, a saída do CMake mostrará o comando apropriado a ser executado (que depende do diretório de versão configurado). Mas este comando produzirá uma compilação de depuração que não funciona no Windows e resulta em um erro de importação Numpy no FreeCAD (que é um problema conhecido, mas difícil de corrigir). Você precisa especificar a opção --config Release para forçar uma compilação de Release:

cmake --build E:/release --config Release

Observe que a configuração de variáveis CMake como CMAKE_BUILD_TYPE não tem nenhum efeito, apenas especificar a opção --config como mostrado acima funciona.

msbuild ALL_BUILD.vcxproj /p:Configuration=Release

msbuild INSTALL.vcxproj /p:Configuration=Release

compile-FC install

Executando e instalando o FreeCAD

Existem 2 métodos para executar o FreeCAD compilado:

Método 1: Executar o FreeCAD.exe que você encontrar em sua pasta de compilação no compartimento de subpasta bin

Método 2: Criar o destino INSTALL

O método 2 é o mais simples porque garante automaticamente que todas as bibliotecas necessárias para executar o FreeCAD.exe estão na pasta correta. O FreeCAD.exe e as bibliotecas serão gerados na pasta especificada na variável CMake CMAKE_INSTALL_PREFIX.

Para o Método 1, você precisa habilitar as opções FREECAD_COPY_* mencionadas na etapa Configuração do CMake acima.

Solucionando problemas

Ao executar o FreeCAD, você pode encontrar DLLs ausentes ao usar determinadas bancadas de trabalho ou recursos de bancadas de trabalho. A mensagem de erro no console do FreeCAD não informará qual DLL está faltando. Para descobrir isso, você deve usar uma ferramenta externa:

• Baixe a versão mais recente do programa Dependências: https://github.com/lucasg/Dependencies/releases (escolha o arquivo Dependencies_x64_Release.zip)
• No console Python do FreeCAD execute estes comandos:

import os os.system(r"~\DependenciesGui.exe") Nota: Em vez do ~ você deve especificar o caminho completo para o DependenciesGui.exe em seu sistema.

• Agora arraste o arquivo *.pyd da bancada de trabalho com a qual você obtém DLLs ausentes relatadas.

Atualizando a compilação

FreeCAD é muito ativamente desenvolvido. Portanto, seu código-fonte muda quase diariamente. Novos recursos são adicionados e bugs são corrigidos. Para se beneficiar dessas mudanças no código-fonte, você deve reconstruir seu FreeCAD. Isso é feito em duas etapas:

1. Atualizando o código-fonte
2. Recompilação

Atualizando o código-fonte

Usando um frontend

Ao usar o frontend Git TortoiseGit: Clique com o botão direito do mouse na pasta de código-fonte do FreeCAD no explorador de arquivos do Windows e selecione Pull no menu de contexto. Uma caixa de diálogo será exibida. Selecione a ramificação de desenvolvimento que você deseja obter. mestre é o ramo principal. Portanto, use isso, a menos que você queira compilar um novo recurso especial de uma ramificação que ainda não foi mesclada ao mestre. (Para obter mais informações sobre ramificações do Git, consulte Processo de desenvolvimento do Git.)

Por fim, clique em OK.

Usando a linha de comando

Abra um terminal (prompt de comando) e alterne para o diretório de origem. Em seguida, digite:

git pull https://github.com/FreeCAD/FreeCAD.git master

onde mestre o nome do ramo de desenvolvimento principal. Se você quiser obter código de outra ramificação, use seu nome em vez de mestre.

Recompilação

1. Abra o IDE do MSVC clicando duas vezes no FreeCAD.sln de arquivo ou no ALL_BUILD.vcxproj de arquivo na pasta de compilação.
2. Continue com a etapa 2 da seção Criando com o Visual Studio 15 2017.

Atualizando o LibPack

Se uma nova versão principal de uma dependência de terceiros, como o Open Cascade, for lançada, ou se uma dependência de terceiros tiver correções de bugs importantes, uma nova LibPack será lançada. Você pode encontrar a versão mais recente aqui.

Para atualizar seu LibPack, a seguinte receita é a prática recomendada:

1. Exclua a pasta bin na pasta de compilação.
2. Mude para a pasta LibPack local e exclua tudo lá.
3. Extraia o conteúdo do novo arquivo ZIP LibPack para a pasta LibPack local existente, mas agora vazia.
4. Abra o CMake e pressione o botão Configurar e, em seguida, o botão Gerar. Isso recria a pasta bin que você acabou de excluir e também copia os novos arquivos LibPack para ela.
5. No CMake, clique no botão Abrir projeto e o IDE do MSVC será aberto.
6. No IDE do MSVC, compile o destino INSTALL.

Ferramentas

Para participar do desenvolvimento FreeCAD você deve compilar e instalar as seguintes ferramentas:

Plugin Qt Designer

FreeCAD usa Qt como kit de ferramentas para sua interface de usuário. Todas as caixas de diálogo são configuradas em arquivos de interface do usuário que podem ser editados usando o programa Qt Designer que faz parte de qualquer instalação do Qt e também está incluído no LibPack. O FreeCAD tem seu próprio conjunto de widgets Qt para fornecer recursos especiais, como adicionar uma unidade aos campos de entrada e definir propriedades de preferências.

Compilação

O plugin não pode ser carregado pelo Qt Designer se ele foi compilado usando outra versão do Qt que não aquela em que seu Qt Designer/Qt Creator é baseado. Portanto, o plugin deve ser compilado junto com o FreeCAD:

• Nas opções do CMake (consulte esta seção acima), habilite a opção BUILD_DESIGNER_PLUGIN e reconfigure.
• abra o MSVC e crie o FreeCAD_widgets de destino

Como resultado, você obterá o arquivo de plugin FreeCAD_widgets.dll na pasta ~\src\Tools\plugins\widget\Release

Instalação

Para instalar o plugin, copie a DLL para:

• Se você usar o LibPack: para a pasta

~\FreeCADLibs_2_8_x64_VC2019\plugins\designer

• Se você tiver uma instalação completa do Qt: poderá escolher entre a pasta

C:\Qt\5.15.2\msvc2019_64\plugins\designer ou C:\Qt\5.15.2\msvc2019_64\bin\designer (você deve primeiro criar a subpasta designer.) (adapte os caminhos à sua instalação!).

Finalmente (re)inicie o Qt Designer e verifique seu menu Ajuda → Plugins. Se o plugin FreeCAD_widgets.dll estiver listado como sendo carregado, agora você pode projetar e alterar os arquivos .ui do FreeCAD. Caso contrário, você deve compilar a DLL por si mesmo.

Se você preferir usar o Qt Creator em vez do Qt Designer, o arquivo do plugin deve ser colocado nesta pasta:C:\Qt\Qt5.15.2\Tools\QtCreator\bin\plugins\designer Em seguida, (re)inicie o Qt Creator, alterne para o modo Design e, em seguida, verifique o menu Ferramentas → Editor de Formulários → Sobre os plug-ins do Qt Designer. Se o FreeCAD_widgets.dll do plugin estiver listado como sendo carregado, agora você pode projetar e alterar os arquivos .ui do FreeCAD. Caso contrário, você deve compilar a DLL por si mesmo.

Provedor de miniaturas

FreeCAD tem o recurso para fornecer miniaturas de visualização para *. Arquivos FCStd. Isso significa que no explorador de arquivos do Windows *. Os arquivos FCStd são mostrados com uma captura de tela do modelo que ele contém. Para fornecer esse recurso, o FreeCAD precisa ter o arquivo FCStdThumbnail.dll instalado no Windows.

Instalação

A DLL é instalada desta forma:

1. Baixe este arquivo ZIP e extraia-o.
2. Abra um prompt de comando do Windows com privilégios de administrador (esses privilégios são um requisito).
3. Mude para a pasta onde a DLL está.
4. Execute este comando

   regsvr32 FCStdThumbnail.dll
   

Portanto, verifique se funciona, certifique-se de que no FreeCAD a opção de preferências Salvar miniatura no arquivo de projeto ao salvar o documento esteja ativada e salve um modelo. Em seguida, exiba no Windows Explorer a pasta do modelo salvo usando um modo de exibição de símbolo. Agora você deve ver uma captura de tela do modelo na exibição de pasta.

Compilação

Para compilar o FCStdThumbnail.dll

1. Mude para a pasta de origem do FreeCAD
   ~\src\Tools\thumbs\ThumbnailProvider
2. Abra a GUI do CMake
3. Especifique como pasta de origem aquela em que você está atualmente.
4. Use a mesma pasta que a pasta de compilação.
5. Clique em Configurar
6. Na caixa de diálogo exibida, especifique o gerador de acordo com o que você deseja usar. Para o MS Visual Studio padrão, use o Visual Studio xx 2yyy onde xx é a versão do compilador e 2yyy o ano de seu lançamento. É recomendável usar a opção padrão Usar compiladores nativos padrão.
   Nota: É importante especificar a variante de bits correta. Se você tiver a variante de 64 bits do LibPack, você também deve usar o compilador x64.
7. Clique em Gerar.
8. Agora você deve ter o arquivo ALL_BUILD.vcxproj na pasta ~\src\Tools\thumbs\ThumbnailProvider. Clique duas vezes nele e o IDE MSVC será aberto.
9. Na barra de ferramentas do IDE MSVC certifique-se de que você use a versão de destino de compilação.
10. Há uma janela chamada Gerenciador de Soluções. Clique com o botão direito do mouse em ALL_BUILD e escolha Compilar.
11. Como resultado, agora você deve ter um FCStdThumbnail.dll na pasta ~\src\Tools\thumbs\ThumbnailProvider\release que você pode instalar conforme descrito acima.

Compilando o Open Cascade

O LibPack vem com uma versão do Open Cascade que é adequado para uso geral. No entanto, sob algumas circunstâncias, você pode querer compilar contra uma versão alternativa do Open Cascade, como um de seus lançamentos oficiais, ou um fork corrigido.

Ao compilar o Open Cascade para FreeCAD, observe que não há garantia de que o FreeCAD funcionará com todas as versões do Open Cascade. Observe também que quando você estiver usando a biblioteca Netgen, você deve usar a versão NetGen que ele aprovou para compilar com a versão Open Cascade que você gosta de compilar.

Para compilar:

• Primeiro, obtenha o código-fonte do Open Cascade, diretamente do repositório git do Open Cascade ou clonando o fork de outra pessoa, como o fork "blobfish" mantido pelo membro do fórum FreeCAD tanderson69.

• Em seguida, abra a GUI do CMake para configurar o sistema de compilação de maneira semelhante à compilação do FreeCAD. Estas opções do CMake têm de ser definidas (ou explicitamente não definidas):

• Abra o projeto no Visual Studio e primeiro compile os destinos ALL_BUILD e, em seguida, INSTALL no modo de versão.
• Repita a criação dos dois destinos no modo Depurar.

Para compilar o FreeCAD usando o Open Cascade auto-compilado, você deve fazer o seguinte:

• Copie todas as pastas do INSTALL_DIR para a pasta LibPack (substitua os arquivos existentes)
• Alterne para a pasta LibPack e vá lá para a subpasta cmake
• Abra lá o arquivo OpenCASCADEDrawTargets.cmake com um editor de texto
• Procure caminhos absolutos para sua pasta LibPack e remova-os. Assim, por exemplo, o caminho

absoluto D:/FreeCADLibs_12.5.4_x64_VC17/lib/freetype.lib torna-se apenas freetype.lib

• Faça o mesmo para o arquivo OpenCASCADEVisualizationTargets.cmake

Compilando redes

O LibPack vem com uma versão do Netgen que será testada para ser construída com a versão Open Cascade do LibPack. O problema é que cada nova versão do Netgen altera a API. Além disso, cada nova versão do Open Cascade faz o mesmo. Portanto, não se pode simplesmente mudar facilmente a versão Netgen.

No entanto, você pode criar Netgen no entanto. Esta é uma tarefa fácil:

• Primeiro obtenha o código-fonte da Netgen, diretamente do repositório git da Netgen.
• Em seguida, abra a GUI do CMake para configurar o sistema de compilação de maneira semelhante à compilação do FreeCAD. Estas opções do CMake têm de ser definidas:

• Além disso, você precisa adicionar uma nova entrada CMake:

nome: CMAKE_DEBUG_POSTFIX, tipo: string, conteúdo: _d Isso garante que os nomes de arquivo das bibliotecas de depuração recebam outro nome que não as bibliotecas de versão e não possam ser trocados acidentalmente.

• Pressione o botão Configurar no CMake para gerar os arquivos *.cmake.
• Somente necessário se houver suporte para CPU mais antiga que não tenha o conjunto de instruções AVX2:
  • Pesquise na pasta de compilação do Netgen o arquivo netgen-targets.cmake e abra-o com um editor de texto. Remova a configuração ;/arch:AVX2 na INTERFACE_COMPILE_OPTIONS Opção.
  • Pressione o botão Configurar no CMake novamente.
• Pressione o botão Gerar no CMake.
• Abra o projeto no Visual Studio e primeiro compile os destinos ALL_BUILD e, em seguida, INSTALL no modo de versão.
• Repita a criação dos dois destinos no modo Depurar.

Para compilar o FreeCAD usando o Netgen auto-compilado, você deve fazer o seguinte:

• Copie todas as pastas do CMAKE_INSTALL_PREFIX para a pasta LibPack (substitua os arquivos existentes)

Referências

Veja também

Compilação - Acelerando

Licença

Compilar no linux

Index

User documentation

• Getting started
• Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
• Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate

---

• Help: Tutorials, Video tutorials
• Workbenches: Std Base, Assembly, BIM, CAM, Draft, FEM, Inspection, Material, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Surface, TechDraw, Test Framework

---

• Addons: Addon Manager, External workbenches, Scripting and macros

---

• Hubs: User hub, Power users hub, Developer hub